Button Settings

Description

The Button Settings determine the style of a button item when it is placed on a ControlBar. This includes specifying whether an icon or text will be used for a button and how the button will appear when it is pressed or hovered over.

Name
Description
Special button type

Specify if the button has a built-in action. (In which case you will not need to define the code for the button in an Action).

Button layout

The Button layout property defines whether an image, some text, or a combination of image and text are used for a ControlBar button.

Sub-theme

The sub-theme to use for the ControlBar button.

Button style

In-line styles applied to the button.

Button class name

One or more classes applied to the button.

Hover class name

One or more classes applied when the user hovers the mouse over the button.

Pressed class name

One or more classes applied when the button is pressed.

Disabled class Name

One or more classes applied to the button when it is disabled.

Button text

The text shown on the button.

Show expression

The show expression property is a logical expression. If the expression evaluates to false, the button will not be shown on the ControlBar. The expression can reference data properties.

Disabled expression

The disabled expression is a logical expression. If the expression evaluates to false, the button will be enabled. If false, the button will be disabled. The expression can reference data properties.

Auto-hide disclosure

Specify if the currently open disclosure (if any) should be closed when the button is tapped.

Bubble help

Specify the text for the bubble help.

Button keep pressed

Specify if the button that was pressed should be shown in its pressed state after the user stops pressing on the button.

Button first button class name

The class name to put on the first button in the list.

Button last button class name

The class name to put on any button in the list that isn't the first or last.

Button middle button class name

The class name to put on the last button in the list.

Disabled icon

Icon shown when the button is disabled.

Hover icon

Icon shown when the user hovers the mouse over the button.

Icon

The 'Icon' property specifies the icon that will appear on a button. In order to access the Icon property you must first select an option from the 'Button layout' property that contains an 'Image'.

Icon class name

One or more classes applied to the button's icon.

Icon style

In-line styles applied to the button's icon.

Pressed icon

The icon shown when the button is pressed.